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This assembler uses 5K of RAM, and resides at the top of the memory, i.e. 
it uses locations 27648 to 32767. The RAMTOP system variable is automatically set 
to prevent loss of the assembler by overwriting with BASIC, or with the NEW command. 


To use the assembler, simply LOAD it from cassette, using the filename ZXAS, 
then RUN the program. This transfers the assembler to the top of the memory. 
Lines 10, 20, and 30 can now be deleted, and the assembler is ready for use. 


biapdard Z110g mnemonics are understood by the assembler (with Lhe exception 
of using full stops instead of commas, to aid keying in the mnemonics). The 
instructions are entered into the BASIC program inside REM statements, with more 
than one instruction per line being allowed if they are separated by semi colons. 
The entire assembly listings are enclosed in brackets, which are also in REM 
statements. Comments may be placed in the listings by typing * , followed by 
the comment. 


As each instruction is processed by the assembler, there are various outputs 
to the television screen, a typical example being 


100 408A 76 HALT 


This simply means that the instruction HALT occurs at line 100 of the listings, 
the machine code for HALT is 76 (hexadecimal), and that the instruction was 
assembled into location 408A (hexadecimal). This information is displayed, 

and when the screen is full you have to press a key for assembly to continue 
(pressing break at any time during assembly will terminate the program). 
Assembly will finish with an error message at the bottom of the screen; 

these having the following meanings; 


Error 0 - no mistakes 

Error 1 - no ( found 

Error 2 - no ) found 

Error 3 - illegal label 

Error 4 - illegal instruction 

Error 5 — number out of range 

Error 6 - relative jump out of range 


To assemble the machine code, simply GO TO 9000, when you will be prompted for the 
starting location for the machine code (see later for typical values). Since not all of 
the instructions can be fully assembled immediately (e.g. jumps forward to a label), the 
assembler will process every instruction twice - a two pass assembly. 


Numbers are assumed to be decimal, unless preceded by $, when they are interpreted as 
hexadeimal, Thus the two instructions ADD A.34 and ADD A./22 are equivalent, with them 
botn meaning add 34 (decimal) to the accumulator. Up to 256 labels are allowed, these 
being denoted by :L followed by the label number followed by the corresponding instruction. 
Thus the allowed labels range from :LO to :L255. These labels are useful for jump and 
call instructions, and as temporary stores for data. This last use is illustrated by the 
following, which uses L30 as a "variable", 


: L3ONOP | 


The label 30 has to be used to derine the location initially, and must be filled with 
a dummy instruction. Instead of using labels with relative jumps, the displacement byte 
May be used, as long as it is preceded by + or - as appropriate. Thus the following two 
portions of code are equivalent: 


i) JR 241 ii) -JR 2.15 
INC HL INC HL 
LD (HL) .A4 :L5LD (KL) .A 


As an example routine, type in the following, which will produce a delay of up to 25.6 
seconds in steps of 0,1 seconds (the actual delay is determined by the value with which 
b is initialized with in line 20). 


10 REM ( 

20 REM LD B.O;LD DE.AFFFF 

20 REM 1 [1.0 HL.14120; ; LLADD HL.DE 
40 REM JR C.L2;DJNZ.L1;RET 

50 REM ) 


9 
At the end of the machine code, you should RETurn to BASIC, Pressing the break käy 
Will have no effect in a machine code routine; thus it is a good idea to test for this at 


various places, The code below will loop until the break key is pressed, when you will 
be retumed to BASIC. Note that this uses a routine in Sinclair's ROM. 

10 REM ( 

20 REM CALLSF43;JR C.-5;RET 

30 REM ) 


machine code programs often result in loss of the program, thus it is advisable to SAVE 
the program before the machine code is executed (this simply being done by a USR call to 
the beginning of the routine). 


Memory is only SAVEA as far as the memory location contained in the system variable 
E-LINE, thus unless the code is assembled into a part of the program, it will not be saved, 
The listings, however, are saved. If it is the machine code rather than the listings 
that you wish to save then the following procedure should be followed. Make the first 
line of the program a REM statemenz, and make the line long enough to accomodate all of the 
assembled code. Then assemble the code into location 16514 and onwards (location 16514 
is the first character after REM), and delete all of the listings. The program may now be 
saved (the assembler is not saved by the SAVE command), with the machine code safely inside 
the program, i 

If there is no need to save the assembled code, then it may be assembled into the spare 
region or memory - STKEND points to this (see page 171 of the ZX81 manual). You should 
remember that if you come back Lo the listing program at a later date, the assembler should 
be in the ZX81, so follow this 'rocedure. Load the assembler, run it, then type NEW, then 
load in tne Listings, wnen you are ready to reassemble the listings. 


Unfortunatelv, space does not permit detailed comments on Z80 instructions, thus 
the user should consult books such as "The Z80 Instruction Handbook", or any text on: 
280 programming. These sheets are only a description of how to use ZXAS, and are 
not a course in machine code programming. i 


THE MNEMONICS 
Various abbreviations are used in the following list of instructions: 


r is any single register, i.e. A, B, C, D, E, H or L 

dis is a one byte displacement, in the range -128 to +127 

data is immediate data, either one or two byes as appropriate 

mem is either (HL, (1X+dis) or (IY+dis). These latter two instructions take 


the value of designated index register, add on the displacement to obtain 
an address which is used in the instruction. 


The first three letters of most instructions are important, so you must get these 


correct, especiall 


the spaces. 


ADC A.mem ADC A.r ADC A.data ADC HL.BC 

ADC HL.DE ADC HL.HL ADC HL.SP ADD A.mem 

ADD A.r ADD A.data ADD HL.BC ADD HL.DE 

ADD HL.HL ADD HL.SP ADD IX.BC ADD IX.DE 

ADD IX.IX ADD IX.SP ADD IY.BC ADD IY.DE 

ADD TY.IY ADD IY.SP AND mem AND r 

AND data BIT O.mem BIT O.r BIT I.mem 

BIT 1.r BIT 2.mem BIT 2.r BIT 3.mem 

BIT 3.r BIT 4.mem "BIT 4.r BIT 5.mem 

BIT 5.r BIT 6.mem BIT 6.r BIT 7.mem 

BIT 7.r CALL address CALLC .address CALLM.address 
CALLNC. address CALLNZ.address CALLP.address CALLPE. address 
CALLPO.address CALLZ address CCF CP mem 

CP r CP data CPD CPDR 

CPI CPIR CPL DAA 

DEC mom DEC r DEC HC DEC DE 

DEC HL DEC IX DEC IX DEC SP 

DL DJNZ .dis El EX (SP).HL 

EX (SP).1X EX (SP).1Y EX AF.AF EX DE.HL 

EXX HALT IMO IMI 

1M2 IN r.(C) IN A.port INC mem 

INC r INC BC INC DE INC HL 

INC IX INC JY INC SP IND 

INDR INI INIR JP (HL) 

JP (IX) JP (IV) JP address JP C.address 
JP M.address JP NC.address JP NZ .address JP P.address 
JP PE.address JP PO.address JP Z.address JR dis 

JR C.dis JR NC.dis JR NZ.dis JR Z.dis 

LD (address) .A LD (address) .BC LD (address) .DE LD (address) .HL 
LD (address) .1X LD (address) .1Y LD (address) .SP LD (BC).A 

LD (DE).A LD mem.r LD mem.data LD A. (address) 
LD A. (BC) LD A. (DE) LD r.r. LD r.data 

LD r.mem LD A.I ID A.R LD BC. (address) 
LD BC.data LD DE. (address) LD DE.data LD HL. (address) 
LD HL.data LD I.A LD IX. (address) LD IX.data 

LD IY. (address) LD TY.data LD R.A LD SP. (address) 
LD SP.data LD SP.HL LD SP.IX LD SP.IY 

LDD LDDR LDL LDIR 

NEG NOP OR mem OR r 

OR data OTDR OTIR OUT (C).r 

OUT port.A OUTD OUTI POP AF 

POP BC POP DE POP HL POP IX 

POP TY PUSH AF PUSH BC PUSH DE 

PUSH HI PUSH TX PUSH LY KES O.mem 
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mem 
00 

20 
A.mem 
HL .DE 
O.mem 
2.mem 
4 .mem 
6.mem 
mem 
mem 
data 


RES 1.r 
RES 3.r 
RES 5.r 
RES 7.r 
RET NC 
RET PO 

RL mem 
RLC r 

RR r 

RRCA 

RST 10 
RST 30 
SBC A.data 
SBC HL.SP 
SET 1.mem 
SET 3.mem 
SET 5.mem 
SET 7.mem 
SRA mem 
SUB mem 
XOR r 


ata 


